home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr51 / lib201.zip / SHANA.TXT < prev    next >
Text File  |  1993-03-29  |  4KB  |  59 lines
  1. *--   SHANA.TXT
  2. *-----------------------------------------------------------------------------
  3. *--     Author's note about Hebrew-calendar functions:
  4. *--     My main source for these algorithms was "The Comprehensive Hebrew
  5. *--     Calendar" by Arthur Spier, Third Revised Edition, Philipp Feldheim Inc.,
  6. *--     Spring Valley, NY, 1986, but I never could have understood it without
  7. *--     first, the fine materials given me by Dave Krajcar, ("Altsol"), of
  8. *--     Alternative Solutions, Inc., at considerable personal expense and
  9. *--     inconvenience, and second the simplified introduction provided by
  10. *--     "Understanding the Jewish Calendar", by Rabbi Nathan Bushwick,
  11. *--     Moznaim Publishing Corporation, Brooklyn, 1989.  Any mistakes in
  12. *--     applying the algorithms are entirely mine.
  13. *--             The main function in importance is Roshashana ( sorry for
  14. *--     the spelling, but the number of characters allowed in dBASE cannot
  15. *--     exceed 10 ); I have no means of checking whether or not it works
  16. *--     properly for periods outside the period 1900-2100.
  17. *--             If you try to create a calendar, you will find that using
  18. *--     these functions repeatedly is very slow because they are set up to
  19. *--     recalculate Rosh Hashanah from scratch on each call.  This is
  20. *--     required by passing only the year as a parameter and returning only
  21. *--     a date; you can easily adapt them so the date, hour and chalokim
  22. *--     of each Molad Tishri and date of each Rosh Hashanah are saved in
  23. *--     public variables between calls and made available to later calculations.
  24. *--             Note also that given the date and time of one Molad Tishri,
  25. *--     finding the next or previous one requires only adding or subtracting
  26. *--     12 or 13 times the length of a lunar month.  Then, applying the
  27. *--     dechiyoth to the date and time of the Molad Tishri will find Rosh
  28. *--     Hashanah, and the dates of it and its predecessor can be used to find
  29. *--     the kebiah.  Given the kebiah and the date of Rosh Hashanah, the
  30. *--     entire calendar is known and can be constructed from code like that
  31. *--     in the latter part of the Dat2Heb() function.
  32. *--             If using these functions for purposes such as figuring out
  33. *--     when a boy is bar mitzvah, please remember some details: a child born
  34. *--     after sundown has a Hebrew birthday matching the next civil day,
  35. *--     anniversaries of events occurring in Adar follow special rules, and
  36. *--     many congregations postpone the celebration if the birthday falls
  37. *--     on the Sabbath or if the celebration would fall on certain major
  38. *--     Sabbaths.  In addition, see the notes to the Civildate() function
  39. *--     about Heshvan and Kislev 30, particularly in connection with
  40. *--     Yahrzeit, determining the anniversary of a death.
  41. *--             I don't know Hebrew or Yiddish; my sources use different
  42. *--     transliterations of words and I have in some cases used one form,
  43. *--     in others another.  If my spelling, or use of words such as "Hebrew"
  44. *--     that have on too many occasions been used as epithets, gives offense,
  45. *--     I apologize.  Suggest more neutral terms that still convey what it
  46. *--     is these functions do if you can; I look forward to hearing from
  47. *--     you.  Until then, please believe that I approached this from a
  48. *--     sense of awe at a calendar so accurate and so old, and in a spirit
  49. *--     perhaps akin to that quoted by Rabbi Bushwick from the Gemara,
  50. *--     Shabbos 75b, "Anyone who has the ability to calculate the motions
  51. *--     of the heavenly bodies and does not do so is refusing to see the
  52. *--     greatness of God's work."
  53. *--                                     Jay Parsons
  54. *--                                     Bernardsville, NJ
  55. *--                                     March 27, 1993 ( Nisan 5, 5753 )
  56. *--
  57. *-------------------------------------------------------------------------------
  58.  
  59.